home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / util / misc / memo20.lha / MemoMetri.doc < prev    next >
Encoding:
Text File  |  1994-05-24  |  5.4 KB  |  182 lines
  1.  
  2.   MemoMetri
  3.   ~~~~~~~~~
  4.     Version 2.0 (22-May-94)
  5.     Copyright © 1992, 1993, 1994 Petri Airio
  6.  
  7.   INTRODUCTION
  8.  
  9.       MemoMetri is a yet another memory gauge.  Nothing special,
  10.     you say!  But hold on a minute, there's something that holds
  11.     a  wide  gap  between  MemoMetri  and  all  the rest similar
  12.     programs - it's that magic thing called configurability!
  13.       Have  you ever seen a typical memory or a disk gauge? They
  14.     have  constant  window  size,  constant  look  and  two menu
  15.     options,  About and Quit.  Even IF (I'm yet to see one) they
  16.     allow  you  to  select  the  color  pens used, the author is
  17.     usually   stucked   with   his/her  four-color  out-of-dated
  18.     Kludgebench  Screen,  and is unable too see the world around
  19.     him...
  20.       Well,  as  I've  said, MemoMetri really is configurable...
  21.     You can define pens, you can define window size...  And much
  22.     more!   And  everything  via  a  nice  Intuition  interface!
  23.  
  24.   USING THE PROGRAM
  25.  
  26.       MemoMetri    can    be    executed    via    "run"    from
  27.     s:Startup-Sequence  OR  you  can  alternatively drop it into
  28.     your WBStartup drawer.
  29.       The  window  has two gauges, one for Chip and one for Fast
  30.     RAM.   By  default  they show the RAM available, but you can
  31.     alternatively tell MemoMetri to display the RAM used.
  32.       OK,  now try the menues!  "About"...  Nothing spectacular.
  33.     "Menufy"...   Try  it and look at the Tools menu!  "Quit" is
  34.     obvious.
  35.       But then, there's the magic:  "Preferences"!
  36.  
  37.   KEYCOMMANDS
  38.  
  39.     ESC/q    -    quit
  40.     s        -    save prefs    (save to envarc: and env:)
  41.     u        -    use prefs    (save to env:)
  42.     m        -    menufy
  43.     p        -    open preference window
  44.     a        -    toggle availwindow on/off
  45.     f        -    flush memory
  46.     r        -    reset snapshot value
  47.  
  48.     Keycommands can be used in both windows.
  49.  
  50.  
  51.   THE PREFERENCES WINDOW
  52.  
  53.     Color Pens:
  54.  
  55.       Window background  - obvious
  56.       Bar background     - yep
  57.       Bar fill           - the same
  58.       AvailW background  - SEE BELOW!
  59.       AvailW text        - SEE BELOW!
  60.  
  61.       Easy!   Just  activate  an  option and point the color you
  62.     want it to be - the MemoMetri window is immediately updated!
  63.  
  64.     Task Priority:
  65.  
  66.       Can  be anything within range -127 ... 10.  Values higher
  67.     than 5 are not recommended.  MemoMetri doesn't take much CPU
  68.     time,  so  specifying  1 as priority makes everybody happy -
  69.     other,  priority  0  programs  won't interfere (So it's REAL
  70.     TIME) and important system processes/tasks will go on.
  71.  
  72.     Refresh Time:
  73.  
  74.       Time  (1/100th  seconds)  between  refreshes, that is, how
  75.     often MemoMetri checks the situation.
  76.  
  77.     Titlebar:
  78.  
  79.       Toggle titlebar on and off.
  80.  
  81.     Avail Window:
  82.  
  83.       MemoMetri  can  open  another  window  displaying specific
  84.     information  about  the situation in memory in a similar way
  85.     the  C command Avail does.  The background and text pens are
  86.     freely definable.
  87.  
  88.     Save, Use, Cancel:
  89.  
  90.       MemoMetri  keeps it's config file (MemoPrefs) in ENV:  and
  91.     ENVARC:  volumes, like the Prefs editors do.
  92.  
  93.   LEGAL
  94.  
  95.       This program is MODWARE.  You can freely distribute it as
  96.     long  as  it stays in it's original package.  All rights are
  97.     reserved  - you may NOT modify it.  And the MODWARE concept
  98.     means,  if you like my product, send new hc/trance/techno 
  99.     modules to me!
  100.    
  101.  
  102.   THE AUTHOR
  103.  
  104.     Any suggestions, bug reports etc. should be sent to:
  105.  
  106.       Petri Airio
  107.       Itäinenrantakatu 52 D55
  108.       20810 Turku
  109.       Tel: +358-21-2344110
  110.       Finland
  111.  
  112.  
  113.   HISTORY
  114.  
  115.     v2.0  - Source code tottally rewritten. Added invisible window-
  116.         sizinggadget. Prefswindow redesigned. Flush command
  117.         added.
  118.  
  119.     v1.3  - MANY bugs fixed. 
  120.         Key commands and menus now works from availwindow too!
  121.  
  122.     v1.25 - Many bug fixes
  123.         Snapshot function to the avail window. You can reset snapshot
  124.         values by pressing invisible gadget:
  125.  
  126.  
  127.         --------------------------------------------
  128.         |##########################################|
  129.         | Type   Available  In-Use  Largest  Used  |
  130.         | Chip        621K    402K     616K    5K  |
  131.         | Fast       5794K   1886K    5775K    1K  |
  132.         | Total      6415K   2288K    5775K    6K  |
  133.         |                                          |
  134.         --------------------------------------------
  135.  
  136.  
  137.          Area marked with # = resetgadget
  138.  
  139.  
  140.     v1.21 - Added a invisible window dragging gadgets; now you
  141.         can drag both windows at any point you wish to!
  142.  
  143.     v1.20 - Preference window now work asynchronously with main
  144.         window(s)!
  145.  
  146.       - Following key command added:
  147.  
  148.         ?   - show about requester
  149.  
  150.     v1.16 - Bug fix: Did not close the availwindow on menufy!
  151.  
  152.       - Following key commands added:
  153.  
  154.         a   - toggle availwindow
  155.         esc - quit
  156.         m   - menufy
  157.         p   - open preferences window
  158.         s   - save settings
  159.         u   - use settings
  160.  
  161.     v1.15 - This, first official, release!
  162.  
  163.     v1.0  - You  may  find  it  somewhere,  however,  it was
  164.           accidentally spread and may contain some bugs.  It
  165.           has no prefs window; all settings are in menues.
  166.  
  167.   THE FUTURE
  168.  
  169.     - Correct all (?) the bugs!
  170.     - Maybe I should think about people without flickerfixer and
  171.       make the preferences window little bit smaller?
  172.     - Maybe add ability to use tooltypes in Memo's icon
  173.     - Everything YOU ask!
  174.  
  175.   THANKS TO
  176.  
  177.     - Wouter   van   Oortmerssen   for  the  Amiga  E  compiler!
  178.     MemoMetri  began  as  an  assembler project, but is nowadays
  179.     completely written in E!
  180.  
  181.     - Nuutti Koskinen for intuitive ideas and this document!
  182.